home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / mbull219.zip / MAKEBUL2.DOC < prev    next >
Text File  |  1992-06-24  |  19KB  |  395 lines
  1.  
  2.  
  3.  
  4.  
  5.                           ┌────────────────────────┐
  6.                           │ M  A  K  E  B  u  l  l │
  7.                           └────────────────────────┘
  8.  
  9.  
  10.  
  11.                                 Version 2.19
  12.  
  13.  
  14.  
  15.  
  16.                                  Written by:
  17.  
  18.                                   Tim Rider
  19.                                 4129 Konya Dr.
  20.                               Torrance, CA 90503
  21.  
  22.  
  23.  
  24.                                 The Source BBS
  25.  
  26.                                 (310) 371-3737
  27.  
  28.  
  29.  
  30.  
  31. ┌─────────────────────────┐
  32. │ Definition of Shareware │
  33. └─────────────────────────┘
  34.  
  35.   Shareware distribution gives users a chance to try software
  36.   before buying it. If you try a Shareware program and continue
  37.   using it, you are expected to register. Individual programs
  38.   differ on details -- some request registration while others
  39.   require it, some specify a maximum trial period. With
  40.   registration, you get anything from the simple right to
  41.   continue using the software to an updated program with
  42.   printed manual.
  43.  
  44.   Copyright laws apply to both Shareware and commercial
  45.   software, and the copyright holder retains all rights, with a
  46.   few specific exceptions as stated below. Shareware authors
  47.   are accomplished programmers, just like commercial authors,
  48.   and the programs are of comparable quality. (In both cases,
  49.   there are good programs and bad ones!) The main difference is
  50.   in the method of distribution.  The author specifically
  51.   grants the right to copy and distribute the software, either
  52.   to all and sundry or to a specific group. For example, some
  53.   authors require written permission before a commercial disk
  54.   vendor may copy their Shareware.
  55.  
  56.   Shareware is a distribution method, not a type of software.
  57.   You should find software that suits your needs and
  58.   pocketbook, whether it's commercial or Shareware. The
  59.   Shareware system makes fitting your needs easier, because you
  60.   can try before you buy.  And because the overhead is low,
  61.   prices are low also. Shareware has the ultimate money-back
  62.   guarantee -- if you don't use the product, you don't pay for
  63.   it.
  64.  
  65. ┌────────────────────────┐
  66. │ Disclaimer - Agreement │
  67. └────────────────────────┘
  68.  
  69.   Users of MAKEBull must accept this disclaimer of warranty:
  70.  
  71.   "MAKEBull is supplied as is.  The author disclaims all
  72.   warranties, expressed or implied, including, without
  73.   limitation, the warranties of merchantability and of fitness
  74.   for any purpose.  The author assumes no liability for
  75.   damages, direct or conse-quential, which may result from the
  76.   use of MAKEBull."
  77.  
  78.   MAKEBull is a "shareware program" and is provided at no
  79.   charge to the user for evaluation.  Feel free to share it
  80.   with your friends, but please do not give it away altered or
  81.   as part of another system.  The essence of "user-supported"
  82.   software is to provide personal computer users with quality
  83.   software without high prices, and yet to provide incentive
  84.   for programmers to continue to develop new products.  If you
  85.   find this program useful and find that you are using
  86.   MAKEBull and continue to use MAKEBull after a 21 day trial
  87.   period, you must make a registration payment of $15 to
  88.   Tim Rider.  The $15 registration will license one copy for
  89.   use by a single user on any one computer at any one time,
  90.   but may be freely moved from one computer location to
  91.   another, so long as there is NO possibility of it being used
  92.   at one location while it is being used at another.
  93.  
  94.   Commercial users of MAKEBull must register and pay for their
  95.   copies of MAKEBull within 21 days of first use or their
  96.   license is withdrawn.  Site-License arrangements may be made
  97.   by contacting Tim Rider.
  98.  
  99.   Anyone distributing MAKEBull for any kind of remuneration
  100.   must first contact Tim Rider at the address above for
  101.   authorization.  This authorization will be automatically
  102.   granted upon request and such distributors may begin offering
  103.   MAKEBull immediately (However Tim Rider must still be
  104.   advised so that the distributor can be kept up-to-date with
  105.   the latest version of MAKEBull.).
  106.  
  107.   You are encouraged to pass a copy of MAKEBull along to your
  108.   friends for evaluation.  Please encourage them to register
  109.   their copy if they find that they can use it.  All registered
  110.   users will receive a copy of the latest version of the
  111.   MAKEBull system.
  112.  
  113. ┌───────────────────┐
  114. │ What is MAKEBull? │
  115. └───────────────────┘
  116.  
  117.   MAKEBull is a full-featured, easy-to-use bulletin generator designed for
  118.   BBS SysOps.
  119.  
  120.   A MAKEBull bulletin consists of three main parts.  The Header, the Footer,
  121.   and the Main Body Text.  The Header and Footer and completely independant,
  122.   so you can configure each's color, style, and text seperately.  As of this
  123.   version, the Main Body color can be configured, but all the Main Body must
  124.   be the same color.
  125.  
  126.   MAKEBull saves to an MB files plus a Display File of three formats.  The
  127.   program is capable of saving in Wildcat! 3.0, PC-Board, and ANSI format.
  128.  
  129.   The MB file is for MAKEBull only, it allows MAKEBull to edit a previously
  130.   created bulletin.
  131.  
  132.   The Display File is the file that you use as a bulletin, menu, banner, or
  133.   anything you want to use it as.
  134.  
  135. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  136. ▓▓▓▓█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█▓▓▓▓▓█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█▓▓▓▓▓
  137. ▓▓▓▓█ REGISTERED USERS READ THIS! █░░▓▓▓█ REGISTERED USERS READ THIS! █░░▓▓▓
  138. ▓▓▓▓█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█░░▓▓▓█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█░░▓▓▓
  139. ▓▓▓▓▓▓░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▓▓▓▓▓░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▓▓▓
  140. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  141. │                                                                          │
  142. │ Just plug your MAKEBull key file into this directory.                    │
  143. │                                                                          │
  144. │ NOTE: I recommend that you call The Source every month or so to keep up  │
  145. │       to date with changes.                                              │
  146. └──────────────────────────────────────────────────────────────────────────┘
  147.  
  148. ┌───────────────────┐
  149. │ Setup of MAKEBull │
  150. └───────────────────┘
  151.  
  152.   To install MAKEBull, just copy the following files onto a floppy disk or a
  153.   sub-directory on your hard disk.
  154.  
  155.   ┌──────────────┬───────────┬───────────────────────────────┐
  156.   │ Filename     │ File Size │ Description                   │
  157.   ├──────────────┼───────────┼───────────────────────────────┤
  158.   │ MAKEBUL2.EXE │ 116450    │ MAKEBull 2.1 Executable       │
  159.   │ MAKEBUL2.API │ 4429      │ MAKEBull 2.1 Application File │
  160.   │ MAKEBUL2.HLP │ 7810      │ MAKEBull 2.1 Help File        │
  161.   │ MAKEBUL2.MKB │ 27132     │ MAKEBull 2.1 Headers/Footers  │
  162.   │ MAKEBUL2.CFG │ 1322      │ MAKEBull 2.1 Configuration    │
  163.   └──────────────┴───────────┴───────────────────────────────┘
  164.  
  165.   After you copy all of these six files to the proper directory, then you're
  166.   ready to go!
  167.  
  168. ┌────────────────────────┐
  169. │ How do I use MAKEBull? │
  170. └────────────────────────┘
  171.  
  172.   MAKEBull is a very simple program, and was designed to be easy to use.
  173.  
  174.   Message Window
  175.   ──────────────
  176.  
  177.   When MAKEBull is first run, the message window is displayed in the center
  178.   of the screen.  Inside this window, MAKEBull prints status messages.  The
  179.   messages do not clear when a new one is printed though.  MAKEBull scrolls
  180.   the text inside the window upward when a new message is printed.  Because
  181.   of that, the bottom-most message is always the latest.  Previous messages
  182.   are always visible.
  183.  
  184.   Pull-Down Menu System
  185.   ─────────────────────
  186.  
  187.   There is a pull-down menu system to show you all availible functions.  To
  188.   access this menu, press the ALT key.  You can now scroll through the menu
  189.   system by using your arrow keys.  Press ESC a few times to deactivate the
  190.   menu system.  When you hold down the ALT key you will see the highlighted
  191.   letters on the menu bar.  You can use these letters as a short cut to get
  192.   to the sub-menu that you want to go to quickly.  While you're holding the
  193.   ALT key down, press one of the highlighted letters.  Wherever you see any
  194.   highlighted letters in the program, you can jump to that area by pressing
  195.   the ALT key plus the highlighted letter.
  196.  
  197.   Online Help System
  198.   ──────────────────
  199.  
  200.   There is an online help system in MAKEBull.  The F1 key accesses the help
  201.   system.  Pressing F1 will display a help window applicable to the area of
  202.   the program you are in.  Color and Style selection windows are behind the
  203.   F1 key also.  Press the F1 key while on the pull-down menu bar.  You will
  204.   see a list of other function keys.  These are short cut keys used by more
  205.   experienced users of MAKEBull.
  206.  
  207.   Dialog Boxes
  208.   ────────────
  209.  
  210.   Throughout MAKEBull, you will run into several dialog boxes.  Use the TAB
  211.   key to move throughout the fields.  Standard keys apply to editing fields
  212.   and the online help is always availible through F1.  To save your changes
  213.   use the TAB key to move to the <Ok> button.  If you have goofed and don't
  214.   want to save the changes, move to the <Cancel> button.  Using the ALT key
  215.   short cut can sometimes get you to the <Ok> or <Cancel> quicker, but with
  216.   some dialog boxes, there are multiple fields with the "O" or "C" hot key.
  217.   Also, there is a shortcut to the OK key, which should be familiar to most
  218.   Wildcat! SysOps.  The F10 key will do the same as pressing the OK button.
  219.  
  220.   Learning to use MAKEBull is best accomplished by exploring the program.
  221.  
  222. ┌──────────────────┐
  223. │ Advanced Options │
  224. └──────────────────┘
  225.  
  226.   Automatic Mode
  227.   ──────────────
  228.  
  229.   MAKEBull 2.1 now includes an automatic mode.  You can use MAKEBull inside
  230.   batch files.  The diagram below explains how to use automatic mode.
  231.  
  232.   ┌──────────────┬────────────────────────────────────────────────────────┐
  233.   │ Command Line │ MAKEBUL2 /A<MBFILE> /T<FILEPATH>                       │
  234.   ├──────────────┼────────────────────────────────────────────────────────┤
  235.   │ /A<MBFILE>   │ Specifies a MB file for MAKEBull to load.              │
  236.   │              │                                                        │
  237.   │              │ Example:  /ATESTBULL  (Loads TESTBULL.MB)              │
  238.   ├──────────────┼────────────────────────────────────────────────────────┤
  239.   │ /T<FILEPATH> │ Specifies the full path to the filename MAKEBull will  │
  240.   │              │ use as the main body text.                             │
  241.   │              │                                                        │
  242.   │              │ Example: /TC:\AUTOEXEC.BAT  (Main body text replaced)  │
  243.   │              │                             (with C:\AUTOEXEC.BAT   )  │
  244.   └──────────────┴────────────────────────────────────────────────────────┘
  245.  
  246.   ┌───────────────────────────────────────────────────────────────────────┐
  247.   │ The /A parameter turns automatic mode on and specifies an MB file to  │
  248.   │ load.  The /T parameter is not necessary, but the /A parameter is.    │
  249.   └───────────────────────────────────────────────────────────────────────┘
  250.  
  251.   Intended operation would go something like this...
  252.  
  253.   (1) User creates a new bulletin and edits everything to his/her liking.
  254.  
  255.       [You can leave the body text empty, or not.  If you are going to use]
  256.       [the /T parameter then you need not enter text.                     ]
  257.  
  258.   (2) User saves bulletin.  For example purposes we'll use TESTBULL.MB
  259.  
  260.   (3) User creates event or batch file.  User enters MAKEBUL2 /ATESTBULL as
  261.       the MAKEBull command line.
  262.  
  263.   (4) Event or batch file is run.  MAKEBull loads TESTBULL.MB then saves it
  264.       to disk.
  265.  
  266.   The above operation did absolutely nothing of any importance.
  267.  
  268.   But by using the /T parameter you can make a nice looking bulletin from a
  269.   raw text output from another program.  BBS SysOps may want to use statis-
  270.   tics screens and spice them up a little bit.
  271.  
  272.   When MAKEBull 2.0 is run in automatic mode, it keeps log file of whatever
  273.   it is doing.  MAKEBUL2.LOG is intended for easy trouble-shooting.
  274.  
  275. ┌──────────────┐
  276. │ Registration │
  277. └──────────────┘
  278.  
  279.   Registration of MAKEBull allows you to access the entire program, except
  280.   for the functions which are not yet complete.  When you register MAKEBull
  281.   you will recieve a disk with the latest version of MAKEBull on it, plus a
  282.   key-file.  This key-file is your registration license and has all of your
  283.   registration info encoded in it.  The licensing agreement for MAKEBull is
  284.   documented above in the section "Disclaimer - Agreement".
  285.  
  286.   The registration fee for MAKEBull is $15.  Plus $5 shipping and handling.
  287.  
  288.   An alternate way of delivery is availible.  If you do not wish to pay the
  289.   shipping and handling costs, I will post your key-file on The Source BBS.
  290.   If you choose this method of delivery, it is necessary that you log-on to
  291.   the Source BBS using the name you stated on the registration form below.
  292.   If you do not use the name stated on the registration form, then you will
  293.   not be able to download your key-file.  You will have a message waiting
  294.   on The Source BBS with instructions on how to access your key-file.
  295.  
  296.                                        ┌────────────────────────────────────┐
  297.                                        │      The Source BBS (310) 371-3737 │
  298.                                        │ USR HST Dual Std v.32/v.42/v.42bis │
  299.                                        └────────────────────────────────────┘
  300.  
  301.   Print the following form out and mail it to the address below the form.
  302.   Make all checks out to Tim Rider.
  303.  
  304.   ┌─────────────────────────────────────────────────────────────────────────┐
  305.   │                                                                         │
  306.   │ Name: _________________________________________________________________ │
  307.   │                                                                         │
  308.   │ BBSName: ______________________________________________________________ │
  309.   │                                                                         │
  310.   │ Voice Phone #: ____________________  BBS Phone #: _____________________ │
  311.   │                                                                         │
  312.   │ Address: ______________________________________________________________ │
  313.   │                                                                         │
  314.   │ City: _____________________________ State: ______ Zip Code: ___________ │
  315.   │                                                                         │
  316.   └─────────────────────────────────────────────────────────────────────────┘
  317.  
  318.   ┌────────────────────┐
  319.   │ Tim Rider          │
  320.   │ 4129 Konya Dr.     │
  321.   │ Torrance, CA 90503 │
  322.   └────────────────────┘
  323.  
  324. ┌─────────────────────────┐
  325. │ Release Version History │
  326. └─────────────────────────┘
  327.  
  328.   ┌───────────────┬────────────────┬────────────────────────────────────────┐
  329.   │ Version: 2.19 │ Date: 06/8/92  │ Found out that MAKEBull won't run      │
  330.   │               │                │ from the root directory of a floppy.   │
  331.   │               │                │ This has been fixed.                   │
  332.   │               │                │ (Thanks Bill Dinga for finding this!)  │
  333.   ├───────────────┼────────────────┼────────────────────────────────────────┤
  334.   │ Version: 2.18 │ Date: 05/24/92 │ Embarassing mistake                    │
  335.   ├───────────────┼────────────────┼────────────────────────────────────────┤
  336.   │ Version: 2.17 │ Date: 05/23/92 │ Changed the "View Bulletin" routine to │
  337.   │               │                │ scroll the whole file.  This may cause │
  338.   │               │                │ some problems, though.  Included now   │
  339.   │               │                │ is the whole registered header/footer  │
  340.   │               │                │ file, but only the first five headers  │
  341.   │               │                │ and footers may be saved to disk.      │
  342.   ├───────────────┼────────────────┼────────────────────────────────────────┤
  343.   │ Version: 2.16 │ Date: 04/17/92 │ Maintenence.  I missed a bug.          │
  344.   ├───────────────┼────────────────┼────────────────────────────────────────┤
  345.   │ Version: 2.15 │ Date: 04/02/92 │ Bug-Squashing Spree.                   │
  346.   ├───────────────┼────────────────┼────────────────────────────────────────┤
  347.   │ Version: 2.12 │ Date: 03/30/92 │ Now is fully un-crippled               │
  348.   ├───────────────┼────────────────┼────────────────────────────────────────┤
  349.   │ Version: 2.11 │ Date: 03/21/92 │ Added the Pause at End                 │
  350.   ├───────────────┼────────────────┼────────────────────────────────────────┤
  351.   │ Version: 2.10 │ Date: 02/21/92 │ Merged Headers & Footers into one file │
  352.   │               │                │ Fixed multi-line headers/footers, now  │
  353.   │               │                │ it will show all five lines if it can, │
  354.   │               │                │ or show one if it is only single-line. │
  355.   │               │                │ Increased Header and Footer selection  │
  356.   │               │                │ by allowing some headers to be used as │
  357.   │               │                │ footers...etc...                       │
  358.   └───────────────┴────────────────┴────────────────────────────────────────┘
  359.   ┌───────────────┬────────────────┬────────────────────────────────────────┐
  360.   │ Version: 2.02 │ Date: 01/27/92 │ MAKEBull was using @NOABORT@ instead   │
  361.   │               │                │ of @NOSTOP@                            │
  362.   ├───────────────┼────────────────┼────────────────────────────────────────┤
  363.   │ Version: 2.01 │ Date: 01/18/92 │ Maintenence Version                    │
  364.   ├───────────────┼────────────────┼────────────────────────────────────────┤
  365.   │ Version: 2.00 │ Date: 01/11/92 │ First Release of MAKEBull 2            │
  366.   └───────────────┴────────────────┴────────────────────────────────────────┘
  367.  
  368. ┌────────────────────────────┐
  369. │ Credits - Acknowledgements │
  370. └────────────────────────────┘
  371.  
  372.   I would like to give thanks to the following people...
  373.  
  374.   Daniel Stasinski - For helping me throughout my project, for writing such
  375.                      a great library - ProWindows Profesional.
  376.                                        ──────────────────────
  377.  
  378.   Chip North - For lending me his HST Dual, beta testing, and of course,
  379.                for letting me use his BBS, The Source BBS, as a distribution
  380.                site.
  381.  
  382.   Rudy Lopez  - Beta Tester
  383.   Fred McDole - Beta Tester
  384.  
  385.   Mustang Software - For working hard on Wildcat!
  386.  
  387.   Daniel Stasinski - For giving me a free copy of AddMem, a DOS memory
  388.                      extender.  720k is necessary for my programming!  Wait a
  389.                      sec, I already mentioned Dan.  Oh well.
  390.  
  391.   Domino's Pizza - For giving me hours to work on this program while I waited
  392.                    for them to deliver a pizza.
  393.  
  394.  
  395.